package cn.com.dcsgo.dto;

import cn.com.dcsgo.enums.UserStatusEnum;
import cn.com.dcsgo.validation.ElementsOf;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.List;

/**
 * 添加用户请求参数
 * 笔记：使用枚举类来约束请求参数的取值范围时，当参数值与枚举类中的值不匹配时，会抛出HttpMessageNotReadableException异常
 * 提示信息类似：JSON parse error: Cannot deserialize value of type `cn.com.dcsgo.enums.UserStatusEnum` from number 2: index value outside legal index range [0..1]
 *
 * @author Dcsgo
 * @since 2025/9/28 10:31
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@Schema(description = "添加用户请求参数")
public class SysUserAddDTO {
    /**
     * 用户名
     */
    @NotBlank(message = "用户名不能为空")
    @Schema(description = "用户名")
    private String username;

    /**
     * 密码
     */
    @NotBlank(message = "密码不能为空")
    @Schema(description = "密码")
    private String password;

    /**
     * 邮箱
     */
    @NotBlank(message = "邮箱不能为空")
    @Schema(description = "邮箱")
    private String email;

    /**
     * 手机号
     */
    @NotBlank(message = "手机号不能为空")
    @Schema(description = "手机号")
    private String mobile;

    /**
     * 状态  0：禁用   1：正常
     */
    @NotNull(message = "用户状态不能为null")
    @Schema(description = "用户状态", allowableValues = {"0", "1"}, type = "integer", format = "int32")
    private UserStatusEnum status;

    /**
     * 角色列表
     * 这里的参数校验无法做到添加角色动态更新校验规则
     */
    @ElementsOf(value = {"1", "2", "3"}, message = "角色列表中的元素取值必须为1或2或3")
    @Schema(description = "角色列表", example = "[1,2]")
    private List<Long> roleIdList;
}
